Add Mintlify integration page for Fern #1787

devin-ai-integration · 2025-11-05T14:27:07Z

Add Mintlify integration documentation

Summary

Added a concise documentation page explaining how to integrate Fern-generated SDKs with Mintlify documentation sites. The integration works by referencing Fern's OpenAPI spec (enriched with SDK code samples) in Mintlify's docs.json configuration.

Changes:

Created Mintlify integration page at fern/products/docs/pages/integrations/mintlify.mdx (28 lines)
Added navigation entry in the "Analytics & integrations" section
Added Mintlify card to the integrations overview page
Content kept minimal per feedback: "generate SDKs with Fern → document with Mintlify"

Review & Testing Checklist for Human

⚠️ CRITICAL: OpenAPI registry URL doesn't exist yet - The page documents https://registry.buildwithfern.com/{org}/{api-name}/openapi/openapi.json but this infrastructure hasn't been implemented. Should this PR be merged before or after the registry is live? If merged now, users following these instructions will get 404 errors.
Verify page renders correctly - Navigate to /learn/docs/integrations/mintlify and check formatting, code blocks, and that it matches the concise style requested
Test navigation and card - Verify the Mintlify card appears in /learn/docs/integrations/overview and clicking it navigates to the correct page
Check content completeness - Is the 28-line page sufficient, or does it need more detail about finding org/api-name values, prerequisites on the Fern side, or what the enriched code samples look like?

Test Plan

Preview the page at the preview URL and navigate to the Mintlify integration page
Click through from the integrations overview card
Verify the code sample renders correctly
(Cannot test) Actually using the documented URL will fail until registry infrastructure exists

Notes

Pattern inspired by Speakeasy and Stainless integration pages
Content was intentionally kept very concise per @dannysheridan's feedback: "be concise and dry" and "generate SDKs with Fern → document with Mintlify"
File placement went through iterations based on feedback:
- Initially integrations/sdks/fern.mdx → renamed to mintlify.mdx
- Moved to integrations/docs/mintlify.mdx → moved to integrations/mintlify.mdx (no subdirectory)
- Custom slug and redirects were added then removed per PR comments
There was discussion about productizing the OpenAPI registry with S3/CloudFront, but that implementation was explicitly deferred
Created by @dannysheridan's request in Slack thread
Devin session

- Create new integration page at fern/products/docs/pages/integrations/sdks/fern.mdx - Add navigation entry in docs.yml - Add Fern card to integrations overview page - Follow pattern from Speakeasy and Stainless integration pages Co-Authored-By: [email protected] <[email protected]>

devin-ai-integration · 2025-11-05T14:27:11Z

🤖 Devin AI Engineer

I'll be helping with this pull request! Here's what you should know:

✅ I will automatically:

Address comments on this PR. Add '(aside)' to your comment to have me ignore it.
Look at CI failures and help fix them

Note: I can only respond to comments from users who have write access to this repository.

⚙️ Control Options:

Disable automatic comment and CI monitoring

github-actions · 2025-11-05T14:27:31Z

fern/products/docs/pages/integrations/sdks/fern.mdx

+}
+```
+
+Fern-generated code snippets can now be viewed in your API docs and interacted with in the playground.


⚠️ [vale] _{reported by reviewdog 🐶}
[FernStyles.Current] Avoid time-relative terms like 'now' that become outdated

github-actions · 2025-11-05T14:28:03Z

🌿 Preview your docs: https://fern-preview-989d8949-227e-450d-b6ae-598423f135ce.docs.buildwithfern.com/learn

Co-Authored-By: [email protected] <[email protected]>

github-actions · 2025-11-05T14:32:20Z

🌿 Preview your docs: https://fern-preview-12814522-7e7d-4b7d-b2d7-41148b7b26d7.docs.buildwithfern.com/learn

- Rename file from fern.mdx to mintlify.mdx - Update page title to 'Mintlify' - Update navigation entry in docs.yml - Update overview page card with Mintlify branding - Update slug from sdks/fern to sdks/mintlify Co-Authored-By: [email protected] <[email protected]>

github-actions · 2025-11-05T14:55:14Z

🌿 Preview your docs: https://fern-preview-f8d360d8-3cf8-4557-b91b-762428c9ee44.docs.buildwithfern.com/learn

- Move mintlify.mdx from integrations/sdks/ to integrations/docs/ - Update content to be concise: generate SDKs with Fern → document with Mintlify - Update navigation in docs.yml to point to new docs/ location - Update overview page card href to new docs/ location - Add redirect from old /sdks/mintlify path to new /docs/mintlify path Co-Authored-By: [email protected] <[email protected]>

github-actions · 2025-11-05T18:20:02Z

🌿 Preview your docs: https://fern-preview-263bdcc6-4f58-47db-a6d3-54efba339d11.docs.buildwithfern.com/learn

dannysheridan · 2025-11-05T18:22:48Z

fern/docs.yml

    destination: /learn/docs/getting-started/project-structure
  - source: /learn/docs/alternatives/mintlify
    destination: /learn/docs/getting-started/overview
+  - source: /learn/docs/integrations/sdks/mintlify


undo this change

dannysheridan · 2025-11-05T18:22:58Z

fern/products/docs/docs.yml

        path: ./pages/integrations/postman.mdx
+      - page: Mintlify
+        path: ./pages/integrations/docs/mintlify.mdx
+        slug: docs/mintlify


remove slug

- Remove slug: docs/mintlify from navigation - Remove redirect from /integrations/sdks/mintlify to /integrations/docs/mintlify Co-Authored-By: [email protected] <[email protected]>

github-actions · 2025-11-05T18:25:55Z

🌿 Preview your docs: https://fern-preview-35a2fb4a-98f6-433e-abdc-5e02b6abd573.docs.buildwithfern.com/learn

dannysheridan · 2025-11-05T19:37:31Z

fern/products/docs/docs.yml

      - page: Postman
        path: ./pages/integrations/postman.mdx
+      - page: Mintlify
+        path: ./pages/integrations/docs/mintlify.mdx


Get rid of /docs here

dannysheridan · 2025-11-05T19:38:04Z

fern/products/docs/pages/integrations/overview.mdx


+<Card
+  title="Mintlify"
+  href="/docs/integrations/docs/mintlify"


- Move mintlify.mdx from integrations/docs/ to integrations/ - Update navigation path in docs.yml - Update overview card href from /docs/integrations/docs/mintlify to /docs/integrations/mintlify Co-Authored-By: [email protected] <[email protected]>

github-actions · 2025-11-05T19:43:03Z

🌿 Preview your docs: https://fern-preview-f46999d1-6c88-4eb9-8fe9-d0a92d87b3ff.docs.buildwithfern.com/learn

github-actions bot reviewed Nov 5, 2025

View reviewed changes

Fix Vale warning: remove time-relative term 'now'

5a2ff74

Co-Authored-By: [email protected] <[email protected]>

dannysheridan approved these changes Nov 5, 2025

View reviewed changes

Address PR feedback: remove slug and redirect

f926562

- Remove slug: docs/mintlify from navigation - Remove redirect from /integrations/sdks/mintlify to /integrations/docs/mintlify Co-Authored-By: [email protected] <[email protected]>

dannysheridan approved these changes Nov 5, 2025

View reviewed changes

dannysheridan merged commit f3d75b2 into main Nov 5, 2025
2 checks passed

dannysheridan deleted the devin/1762352751-mintlify-fern-integration branch November 5, 2025 20:22

Add Mintlify integration page for Fern #1787

Add Mintlify integration page for Fern #1787

Conversation

devin-ai-integration bot commented Nov 5, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Add Mintlify integration documentation

Summary

Review & Testing Checklist for Human

Test Plan

Notes

Uh oh!

devin-ai-integration bot commented Nov 5, 2025

🤖 Devin AI Engineer

Uh oh!

github-actions bot Nov 5, 2025

Choose a reason for hiding this comment

Uh oh!

github-actions bot commented Nov 5, 2025

Uh oh!

github-actions bot commented Nov 5, 2025

Uh oh!

github-actions bot commented Nov 5, 2025

Uh oh!

github-actions bot commented Nov 5, 2025

Uh oh!

dannysheridan Nov 5, 2025

Choose a reason for hiding this comment

Uh oh!

dannysheridan Nov 5, 2025

Choose a reason for hiding this comment

Uh oh!

github-actions bot commented Nov 5, 2025

Uh oh!

dannysheridan Nov 5, 2025

Choose a reason for hiding this comment

Uh oh!

dannysheridan Nov 5, 2025

Choose a reason for hiding this comment

Uh oh!

github-actions bot commented Nov 5, 2025

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

devin-ai-integration bot commented Nov 5, 2025 •

edited

Loading